home *** CD-ROM | disk | FTP | other *** search
/ Aminet 44 / Aminet 44 (2001)(GTI - Schatztruhe)[!][Aug 2001].iso / Aminet / mus / play / subspace68k.readme < prev    next >
Text File  |  2001-07-04  |  6KB  |  183 lines
  1. Short:    Geiss/G-Force like plugin for AmigaAMP (68K)
  2. Author:   Thomas Wenzel (68K port by SuRgEoN)
  3. Uploader: SuRgEoN (christian.michael@groenjord.dk)
  4. Type:     mus/play
  5.  
  6.  
  7. VBCC compiled 68K-port of Thomas Wenzel's cool Subspace-plugin for AmigaAmp.
  8.  
  9. Background story:
  10. I wanted a good looking plugin for my recently acquired Mediator/Voodoo3.
  11. Subspace was the most interesting open-sourced non-W3D plugin I could get my hands on.
  12. Unfortunately it is also very demanding with respect to cpu and bandwidth to gfxcard.
  13.  
  14.  
  15. Minimum requirements:
  16. - AmigaOS 3.1
  17. - full 68060 (66MHz is strongly recommended)
  18. - fast gfxcard (Mediator1200 with Voodoo3 will do just fine)
  19. - Picasso96 2.0 or CyberGraphX v3
  20. - 320x200 or 320x240 8-bit screenmodes
  21.  
  22. Performance: (tested with Blizz1260/66 and Mediator1200/Voodoo3-3K, latest mmu driver)
  23. Using medium quality audiodecoding, freqdiv 2 and optimised prefs/settings (see below):
  24. Subspace_68k_LO version  (240x112) 11 fps
  25. Subspace_68k_MED version (272x144) 8 fps
  26. Subspace_68k_HI version  (288x176) 6 fps
  27.  
  28. Subspace will probably not look good on anything less than a 66Mhz 060, sorry.
  29.  
  30.  
  31. How to achieve highest stable framerate for Subspace plugin with AmigaAmp-Prefs:
  32. - set play buffer to 1/10 second
  33. - loadbuffer should be "file" to eliminate HD access
  34. - task priorities: main=1, play=1, vis=0
  35.   (note: side-effect is that you can not change settings while playing)
  36. - decrease the audio quality (freqdiv: 2 or 4, quality: medium or low).
  37.   (note: the plugin should be run at 0 priority with AmigaAmp setup like above)
  38. - choose backdrop and immovable mode (from menu), then save settings.
  39.  
  40.  
  41. Notable changes from PPC/WOS version:
  42. - Picasso96 supported!
  43. - Screenmode Requester (320x200 or 320x240 8-bit modes)
  44. - 'T' key toggles song-title display (default on)
  45. - 'L' key locks/unlocks current waveshape/deltafield combination
  46. - static palettes (palette randomizer produced ugly results too often)
  47. - some ugly waveshapes left out.
  48. - 3 versions: 240x112, 272x136 and 288x176 centered on 320x200 screen
  49. - tooltype support is missing, hence the 3 versions
  50. - source adapted for VBCC (it looks a quite messy:)
  51.  
  52. History (68k version)
  53. - first release
  54.  
  55. Future:
  56. - make it amplifier compatible
  57. - aspect correction for 320x200 screenmode
  58. - maybe add AGA support
  59.  
  60. Thanks:
  61. Thomas Wenzel for AmigaAmp and for open-sourcing for this cool plugin!
  62.  
  63.  
  64. Original readme from Subspace:
  65. ------------------------------
  66.  
  67. Homepage
  68. --------
  69. http://amigaamp.amiga-software.com
  70.  
  71.  
  72. History
  73. -------
  74. v1.0 - initial release
  75.  
  76. v1.1 - more warpfields
  77.      - more waveshapes
  78.      - more colormaps
  79.      - experimental PowerUP version
  80.  
  81. Legal
  82. -----
  83. Copyrighted Open Source Freeware. All restrictions and distribution
  84. conditions of AmigaAMP apply. Based on and inspired by G-Force for
  85. WinAMP.
  86.  
  87. Don't ask me too many things about the PowerUP version! Running several
  88. PowerUP tasks at different priorities is very unstable on my system, so
  89. I decided to use WarpUP which is much more reliable here. However, some
  90. people have reported the contrary, so it's worth a try. If it doesn't
  91. work - bad luck. If it hangs - bad luck. Don't bother me :)
  92.  
  93.  
  94. Usage
  95. -----
  96. Just start the plugin while AmigaAMP is running in skin mode. For the
  97. PowerUP version to run smooth don't set AmigaAMP's PPC decoder priority
  98. to anything higher than 0.
  99.  
  100.  
  101. Key assignments
  102. ---------------
  103. ESC  -  quit
  104. F    -  show framerate on/off
  105. W    -  show waveform on/off
  106. I    -  show info about program on
  107.  
  108. Options/ToolTypes
  109. -----------------
  110. RESOLUTION - LOW = 320x240, HIGH = 640 x 480
  111. SCREENSIZE - Override default vertical screen [25 .. 100] in percent
  112. MAXFPS     - Limit framerate to the number specified
  113.  
  114.  Example
  115.  -------
  116.  RESOLUTION=HIGH
  117.  SCREENSIZE=50
  118.  MAXFPS=10
  119.  
  120.  
  121. Minimum requirements
  122. --------------------
  123. AmigaOS 3.1
  124. CyberGraphX v3
  125. PowerPC 603e or 604e (PowerUP AND WarpUP supported!)
  126. Fast graphics card (Z3, PCI or Local Bus)
  127.  
  128.  
  129. More info
  130. ---------
  131. See AmigaAMP's documentation
  132.  
  133. The framerate heavily depends on the throughput of you graphics bus.
  134. A CyberVisionPPC along with a PPC604e-200 will give you about 20fps
  135. in low resolution/full size and 10fps in high res at 66% screensize.
  136. Everything less is probably slower.
  137.  
  138. It may be nessecary to select at least 1/5s playback buffer in AmigaAMP
  139. for uninterrupted playback.
  140.  
  141. Future plans
  142. ------------
  143.  - More Waveshapes and Warpfields
  144.  - Particles
  145.  - Minor speed optimizations
  146.  
  147.  
  148. ============================= Archive contents =============================
  149.  
  150. Original  Packed Ratio    Date     Time    Name
  151. -------- ------- ----- --------- --------  -------------
  152.     2802    1843 34.2% 04-May-01 10:00:16 +src.info
  153.     5251    1459 72.2% 04-May-01 09:59:42 +Deltafields.c
  154.     5270    1466 72.1% 04-May-01 09:59:42 +Deltafields4.c
  155.     5278    1464 72.2% 04-May-01 09:59:42 +Deltafields_OPT.c
  156.      582     330 43.2% 04-May-01 09:59:42 +makefile
  157.      746     339 54.5% 04-May-01 09:59:42 +makefile.vbccm68k
  158.     1011     381 62.3% 04-May-01 09:59:42 +makefile.vbccm68k_OPT_LO
  159.     1012     382 62.2% 04-May-01 09:59:42 +makefile.vbccm68k_OPT_MED
  160.      247     137 44.5% 04-May-01 09:59:42 +SCOPTIONS
  161.      286     185 35.3% 04-May-01 09:59:42 +smakefile
  162.    33600   10054 70.0% 04-May-01 09:59:42 +Subspace.c
  163.    33369   10100 69.7% 04-May-01 09:59:42 +Subspace68k.c
  164.    36461   10886 70.1% 04-May-01 09:59:42 +Subspace68k2.c
  165.    54597   12283 77.5% 04-May-01 09:59:42 +Subspace68k3.c
  166.    53444   11972 77.5% 04-May-01 09:59:42 +Subspace68k4.c
  167.    55499   12660 77.1% 04-May-01 09:59:42 +Subspace68k_FS.c
  168.    55337   12549 77.3% 04-May-01 09:59:42 +Subspace68k_HS.c
  169.    55608   12669 77.2% 04-May-01 09:59:42 +Subspace68k_MS.c
  170.      632     347 45.0% 04-May-01 09:59:42 +TrackInfo.h
  171.    10711    2376 77.8% 04-May-01 09:59:42 +Waveshapes.c
  172.    10538    2308 78.0% 04-May-01 09:59:42 +Waveshapes4.c
  173.    18495    2620 85.8% 04-May-01 09:59:42 +Waveshapes_OPT.c
  174.     4377    2260 48.3% 04-May-01 09:59:40 +Subspace68k.readme
  175.    47764   24366 48.9% 04-May-01 09:59:42 +Subspace_68k_HI
  176.     1846    1297 29.7% 04-May-01 10:00:16 +Subspace_68k_HI.info
  177.    47724   24307 49.0% 04-May-01 09:59:40 +Subspace_68k_LO
  178.     1846    1298 29.6% 04-May-01 10:00:16 +Subspace_68k_LO.info
  179.    47840   24395 49.0% 04-May-01 09:59:40 +Subspace_68k_MED
  180.     1846    1300 29.5% 04-May-01 10:00:16 +Subspace_68k_MED.info
  181. -------- ------- ----- --------- --------
  182.   594019  188033 68.3% 04-May-101 20:17:52   29 files
  183.